random-access-storage

Abstract interface to implement random-access instances.

• Documentation
• Crate

Why?

This module forms a shared interface for reading and writing bytes to different backends. By having a shared interface, it means implementations can easily be swapped, depending on the environment.

Usage

extern crate random_access_storage;

use random_access_storage::{RandomAccessMethods, RandomAccess};

struct S;
impl RandomAccessMethods for S {
  type Error = std::io::Error;

  fn open(&mut self) -> Result<(), Self::Error> {
    unimplemented!();
  }

  fn write(&mut self, offset: u64, data: &[u8]) -> Result<(), Self::Error> {
    unimplemented!();
  }

  fn read(&mut self, offset: u64, length: u64) -> Result<Vec<u8>, Self::Error> {
    unimplemented!();
  }

  fn read_to_writer(
    &mut self,
    offset: u64,
    length: u64,
    writer: &mut impl std::io::Writer
  ) -> Result<(), Self::Error> {
    unimplemented!();
  }

  fn del(&mut self, offset: u64, length: u64) -> Result<(), Self::Error> {
    unimplemented!();
  }

  fn truncate(&mut self, length: u64) -> Result<(), Self::Error> {
    unimplemented!();
  }

  fn len(&mut self) -> Result<u64, Self::Error> {
    unimplemented!();
  }

  fn is_empty(&mut self) -> Result<bool, Self::Error> {
    unimplemented!();
  }

  fn sync_all(&mut self) -> Result<(), Self::Error> {
    unimplemented!();
  }
}

let _file = RandomAccess::new(S);

Installation

$ cargo add random-access-storage

See Also

• random-access-storage/random-access-storage

License

MIT OR Apache-2.0